docs: use markdown instead of <note>
authorWilliam Jon McCann <william.jon.mccann@gmail.com>
Wed, 5 Feb 2014 04:57:30 +0000 (23:57 -0500)
committerWilliam Jon McCann <william.jon.mccann@gmail.com>
Thu, 6 Feb 2014 13:01:49 +0000 (08:01 -0500)
gdk/gdkevents.h
gdk/x11/gdkdevicemanager-x11.c
gtk/deprecated/gtkactivatable.c
gtk/deprecated/gtkactivatable.h
gtk/deprecated/gtkhandlebox.c
gtk/deprecated/gtkhseparator.c
gtk/deprecated/gtkstyle.c
gtk/deprecated/gtktable.c
gtk/deprecated/gtktearoffmenuitem.c
gtk/deprecated/gtkuimanager.c
gtk/gtkmessagedialog.h

index e5eb17ecf25a49e47a83e54a21e5cb6c5136c84d..458e550bc635e09950e2ea95c88d73e1d4376d91 100644 (file)
@@ -45,12 +45,8 @@ G_BEGIN_DECLS
  *
  * The event structures contain data specific to each type of event in GDK.
  *
- * <note>
- * <para>
- * A common mistake is to forget to set the event mask of a widget so that
- * the required events are received. See gtk_widget_set_events().
- * </para>
- * </note>
+ * > A common mistake is to forget to set the event mask of a widget so that
+ * > the required events are received. See gtk_widget_set_events().
  */
 
 
index 61a958930bd5be90eb3d24e68bb44aefd0a24e04..0dae46d083678d8522a1ee5a1f74f152f3a6ffd2 100644 (file)
@@ -124,13 +124,11 @@ gdk_x11_device_manager_lookup (GdkDeviceManager *device_manager,
  *
  * Returns the device ID as seen by XInput2.
  *
- * <note>
- *   If gdk_disable_multidevice() has been called, this function
- *   will respectively return 2/3 for the core pointer and keyboard,
- *   (matching the IDs for the Virtual Core Pointer and Keyboard in
- *   XInput 2), but calling this function on any slave devices (i.e.
- *   those managed via XInput 1.x), will return 0.
- * </note>
+ * > If gdk_disable_multidevice() has been called, this function
+ * > will respectively return 2/3 for the core pointer and keyboard,
+ * > (matching the IDs for the Virtual Core Pointer and Keyboard in
+ * > XInput 2), but calling this function on any slave devices (i.e.
+ * > those managed via XInput 1.x), will return 0.
  *
  * Returns: the XInput2 device ID.
  *
index f9916019e5daf6c0b5fb36f253b8424735d22887..3d36e391fde67bb3c22dc54650da8d84def162a1 100644 (file)
@@ -274,12 +274,12 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
 {
   /**
    * GtkActivatable:related-action:
-   * 
+   *
    * The action that this activatable will activate and receive
    * updates from for various states and possibly appearance.
    *
-   * <note><para>#GtkActivatable implementors need to handle the this property and 
-   * call gtk_activatable_do_set_related_action() when it changes.</para></note>
+   * > #GtkActivatable implementors need to handle the this property and
+   * > call gtk_activatable_do_set_related_action() when it changes.
    *
    * Since: 2.16
    *
@@ -294,7 +294,7 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
 
   /**
    * GtkActivatable:use-action-appearance:
-   * 
+   *
    * Whether this activatable should reset its layout
    * and appearance when setting the related action or when
    * the action changes appearance.
@@ -302,9 +302,9 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
    * See the #GtkAction documentation directly to find which properties
    * should be ignored by the #GtkActivatable when this property is %FALSE.
    *
-   * <note><para>#GtkActivatable implementors need to handle this property
-   * and call gtk_activatable_sync_action_properties() on the activatable
-   * widget when it changes.</para></note>
+   * #GtkActivatable implementors need to handle this property
+   * and call gtk_activatable_sync_action_properties() on the activatable
+   * > widget when it changes.
    *
    * Since: 2.16
    *
@@ -375,8 +375,8 @@ gtk_activatable_sync_action_properties (GtkActivatable *activatable,
  *
  * Sets the related action on the @activatable object.
  *
- * <note><para>#GtkActivatable implementors need to handle the #GtkActivatable:related-action
- * property and call gtk_activatable_do_set_related_action() when it changes.</para></note>
+ * #GtkActivatable implementors need to handle the #GtkActivatable:related-action
+ * > property and call gtk_activatable_do_set_related_action() when it changes.
  *
  * Since: 2.16
  *
@@ -416,10 +416,10 @@ gtk_activatable_action_notify (GtkAction      *action,
  * method is called when the related #GtkAction properties change
  * and registers to the action's proxy list.
  *
- * <note><para>Be careful to call this before setting the local
- * copy of the #GtkAction property, since this function uses 
- * gtk_activatable_get_related_action() to retrieve the
- * previous action</para></note>
+ * Be careful to call this before setting the local
+ * copy of the #GtkAction property, since this function uses 
+ * gtk_activatable_get_related_action() to retrieve the
+ * > previous action.
  *
  * Since: 2.16
  *
@@ -517,10 +517,10 @@ gtk_activatable_get_related_action (GtkActivatable *activatable)
  * Sets whether this activatable should reset its layout and appearance
  * when setting the related action or when the action changes appearance
  *
- * <note><para>#GtkActivatable implementors need to handle the
- * #GtkActivatable:use-action-appearance property and call
- * gtk_activatable_sync_action_properties() to update @activatable
- * if needed.</para></note>
+ * #GtkActivatable implementors need to handle the
+ * #GtkActivatable:use-action-appearance property and call
+ * gtk_activatable_sync_action_properties() to update @activatable
+ * > if needed.
  *
  * Since: 2.16
   *
index 2fa825ad7388532eccc050e0f77567bd53d8ab40..dd89d85b72adf41f3466e32f2132d4696b35208b 100644 (file)
@@ -44,8 +44,9 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
  * properties that are meant to effect the appearance accordingly.
  * @sync_action_properties: Called to update the activatable completely, this is called internally when
  * #GtkActivatable:related-action property is set or unset and by the implementor when
- * #GtkActivatable:use-action-appearance changes.<note><para>This method can be called
- * with a %NULL action at times</para></note>
+ * #GtkActivatable:use-action-appearance changes.
+ *
+ * > This method can be called with a %NULL action at times.
  *
  * Since: 2.16
  *
index 30b20486ed921b292b793d6b38bd5fe433a33f7e..36a788301c88a20cd370a33a5cbee2fbaf229df2 100644 (file)
  * allocation will remain fixed as the height of the handlebox shrinks,
  * so the snap edge should be set to %GTK_POS_BOTTOM.
  *
- * <note>
- * #GtkHandleBox has been deprecated. It is very specialized, lacks features
- * to make it useful and most importantly does not fit well into modern
- * application design. Do not use it. There is no replacement.
- * </note>
+ * > #GtkHandleBox has been deprecated. It is very specialized, lacks features
+ * > to make it useful and most importantly does not fit well into modern
+ * > application design. Do not use it. There is no replacement.
  */
 
 
index 3a6c42dc5260bb95fb6afd20ef4c31dd0c3f74cf..02fa37d7abaacc76786c4717c4fb6467afe81791 100644 (file)
@@ -39,12 +39,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * widgets within a window. It displays a horizontal line with a shadow to
  * make it appear sunken into the interface.
  *
- * <note>
- * The #GtkHSeparator widget is not used as a separator within menus.
- * To create a separator in a menu create an empty #GtkSeparatorMenuItem
- * widget using gtk_separator_menu_item_new() and add it to the menu with
- * gtk_menu_shell_append().
- * </note>
+ * > The #GtkHSeparator widget is not used as a separator within menus.
+ * > To create a separator in a menu create an empty #GtkSeparatorMenuItem
+ * > widget using gtk_separator_menu_item_new() and add it to the menu with
+ * > gtk_menu_shell_append().
  *
  * GtkHSeparator has been deprecated, use #GtkSeparator instead.
  */
index 0bfd9f49e32fb03c2ae823687a9b821ecd84b6fe..fb6f1d57fae0812822ad0d8092db30223b75836c 100644 (file)
@@ -4375,17 +4375,15 @@ gtk_widget_modify_fg (GtkWidget      *widget,
  * All other style values are left untouched.
  * See also gtk_widget_modify_style().
  *
- * <note><para>
- * Note that “no window” widgets (which have the %GTK_NO_WINDOW
- * flag set) draw on their parent container's window and thus may
- * not draw any background themselves. This is the case for e.g.
- * #GtkLabel.
- * </para><para>
- * To modify the background of such widgets, you have to set the
- * background color on their parent; if you want to set the background
- * of a rectangular area around a label, try placing the label in
- * a #GtkEventBox widget and setting the background color on that.
- * </para></note>
+ * > Note that “no window” widgets (which have the %GTK_NO_WINDOW
+ * > flag set) draw on their parent container's window and thus may
+ * > not draw any background themselves. This is the case for e.g.
+ * > #GtkLabel.
+ * >
+ * > To modify the background of such widgets, you have to set the
+ * > background color on their parent; if you want to set the background
+ * > of a rectangular area around a label, try placing the label in
+ * > a #GtkEventBox widget and setting the background color on that.
  *
  * Deprecated:3.0: Use gtk_widget_override_background_color() instead
  */
@@ -4475,17 +4473,15 @@ gtk_widget_modify_text (GtkWidget      *widget,
  * (see gtk_widget_modify_text()) for widgets such as #GtkEntry
  * and #GtkTextView. See also gtk_widget_modify_style().
  *
- * <note><para>
- * Note that “no window” widgets (which have the %GTK_NO_WINDOW
- * flag set) draw on their parent container's window and thus may
- * not draw any background themselves. This is the case for e.g.
- * #GtkLabel.
- * </para><para>
- * To modify the background of such widgets, you have to set the
- * base color on their parent; if you want to set the background
- * of a rectangular area around a label, try placing the label in
- * a #GtkEventBox widget and setting the base color on that.
- * </para></note>
+ * > Note that “no window” widgets (which have the %GTK_NO_WINDOW
+ * > flag set) draw on their parent container's window and thus may
+ * > not draw any background themselves. This is the case for e.g.
+ * > #GtkLabel.
+ * >
+ * > To modify the background of such widgets, you have to set the
+ * > base color on their parent; if you want to set the background
+ * > of a rectangular area around a label, try placing the label in
+ * > a #GtkEventBox widget and setting the base color on that.
  *
  * Deprecated:3.0: Use gtk_widget_override_background_color() instead
  */
index bfdef2fd278c8b6e0c9b90d263423b28ff6b8b24..c006e87ff29b7af196388354f5fe77599f463b6e 100644 (file)
  * gtk_table_set_homogeneous(), can be used to set whether all cells in the
  * table will resize themselves to the size of the largest widget in the table.
  *
- * <note>
- * #GtkTable has been deprecated. Use #GtkGrid instead. It provides the same
- * capabilities as GtkTable for arranging widgets in a rectangular grid, but
- * does support height-for-width geometry management.
- * </note>
+ * > #GtkTable has been deprecated. Use #GtkGrid instead. It provides the same
+ * > capabilities as GtkTable for arranging widgets in a rectangular grid, but
+ * > does support height-for-width geometry management.
  */
 
 
index c15102b0777e3ea117ce48a138993790392cb875..c850d665f12b81c3c12e0fcb78d75e2c4a2b9cda 100644 (file)
@@ -51,8 +51,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
  * the tearoff menu can be reattached.  Activating it will erase the tearoff
  * menu window.
  *
- * <note>#GtkTearoffMenuItem is deprecated and should not be used in newly
- * written code. Menus are not meant to be torn around.</note>
+ * #GtkTearoffMenuItem is deprecated and should not be used in newly
+ * > written code. Menus are not meant to be torn around.
  */
 
 
index 109aab574551a7ba2dc213648b92a789d2577fe3..955068c41d295871fda887c6e7f3ceabd764f2f5 100644 (file)
  * The UI definitions are specified in an XML format which can be
  * roughly described by the following DTD.
  *
- * <note><para>
- * Do not confuse the GtkUIManager UI Definitions described here with
- * the similarly named <link linkend="BUILDER-UI">GtkBuilder UI
- * Definitions</link>.
- * </para></note>
+ * > Do not confuse the GtkUIManager UI Definitions described here with
+ * > the similarly named <link linkend="BUILDER-UI">GtkBuilder UI
+ * > Definitions</link>.
  *
  * |[
  * <!ELEMENT ui          (menubar|toolbar|popup|accelerator)* >
index 973e39c0d0f952d59957fdba0f5de958df36c4a6..ef082c11f53cbe9c5d402d66645869820a80394b 100644 (file)
@@ -77,11 +77,10 @@ struct _GtkMessageDialogClass
  * Prebuilt sets of buttons for the dialog. If
  * none of these choices are appropriate, simply use %GTK_BUTTONS_NONE
  * then call gtk_dialog_add_buttons().
- * <note>
- *  Please note that %GTK_BUTTONS_OK, %GTK_BUTTONS_YES_NO
- *  and %GTK_BUTTONS_OK_CANCEL are discouraged by the
- *  [GNOME Human Interface Guidelines](http://library.gnome.org/devel/hig-book/stable/).
- * </note>
+ *
+ * > Please note that %GTK_BUTTONS_OK, %GTK_BUTTONS_YES_NO
+ * > and %GTK_BUTTONS_OK_CANCEL are discouraged by the
+ * > [GNOME Human Interface Guidelines](http://library.gnome.org/devel/hig-book/stable/).
  */
 typedef enum
 {